home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Tools / ANIPLAY.209 / ENGLISH / ANIPLAY.TXT < prev    next >
Encoding:
Text File  |  2000-02-19  |  29.7 KB  |  822 lines
  1.                         *----------------*
  2.                         | ANIPLAYER 2.09 |
  3.                         *----------------*
  4.  
  5.  
  6. Introduction:
  7. -------------
  8.  
  9.  This Shareware is a media player written entirely in assembler 68000 
  10. and DSP 56001 (for picture uncompression).
  11.  It can read:
  12.  - QuickTime Movies (MOV).
  13.    Video For Windows (AVI).
  14.    Autodesk Animator (FLI/FLC/FLH).
  15.    MPEG 1/2 (MPG).
  16.  - Interactive Video QuickTime VR (MOV with mouse control).
  17.  - Sounds Audio Visual Research (AVR).
  18.    Microsoft RIFF-WAVE (WAV).
  19.    Apple Interchange File Format (AIF).
  20.    Real Audio (RA 14.4K and 28.8K).
  21.    MPEG 1/2 Audio Layer 1,2,3 (MP1/2/3).   
  22.  - JPEG pictures.
  23.  
  24.  It has been written and particularly optimised for the FALCON.
  25.  The file is being read in direct to disk (D2D) mode, so therefore the 
  26. program requires less memory to work.
  27.  On the Falcon, with a True Color display and the DSP, you can get a 
  28. very smooth animation with sound and without skipping any picture
  29. (a fast CD-ROM drive is required).
  30.  For the moment, only some image compressions use the DSP. The main 
  31. one is the Cinepak (CVID).
  32.  
  33.  The display is in a window, and it's possible to move through the 
  34. movie (using the cursor or tape-recorder buttons) except for 
  35. FLI/FLC/FLH files.
  36.  
  37.  The program supports the VA_START protocol. This enables you to load 
  38. a movie by double-clicking on it (if Aniplayer is assigned for 
  39. AVI/MOV/FLI/MPG/AVR/WAV/AIF/RA/MP/JPG) under the desktop. The program 
  40. will start only once. AV_SENDKEY is also supported. Drag & Drop
  41. with window is possible.
  42.  The program also works as a desk-accessory when renamed as *.ACC.
  43.  Multitasking is supported as well as TTP mode with command line 
  44. parameters.
  45.  
  46.  Aniplayer supports ID4-OLGA protocol (for example as a plug-in for 
  47. your favourite browser).
  48.  
  49.  The program is in french (integrated RSC file) but works in english 
  50. if the file N_FRENCH.TXT appears in the same directory as ANIPLAY.PRG.
  51.  
  52.  
  53. Required Hardware:
  54. ------------------
  55.  
  56.  FALCON advised for true color and DSP.
  57.  TT with graphic card 32768/65536 colors advised.
  58.  Other TOS machine with at least an 68030 and 2 Mbytes of ram (there is 
  59. a risk of 3 bombs on ST(E) because of the large amount of compressions).
  60.  Most graphic modes are supported :
  61.   - All screen resolutions on the FALCON.
  62.   - All ATARI graphics modes using planes.
  63.   - The graphics cards true color 24 bits (type 32 bits motorola
  64.     for PowerMac, or NOVA ET4000 for HADES).
  65.   - The graphic cards 32768/65536 colors Motorola type (e.G.
  66.     MATRIX) or Intel type (for example NOVA).
  67.   - The graphic cards using 256 colors without planes.
  68.  The program works equally well without DMA sound, in this case it's
  69. the YAMAHA which is used (always in direct to disk) or PSOUND card
  70. (on the HADES).
  71.  The floating point coprocessor (68882) is only required for Real Audio
  72. 28.8K.
  73.  
  74.  
  75. Informations:
  76. -------------
  77.  
  78.  A short help is available (HELP) describing the program and its 
  79. options. BubbleGEM may also be installed. The complete documentation 
  80. can be obtained using the hypertext under ST-Guide.
  81.  
  82.  The speed limitations are caused by transfers from the 68030 to 
  83. the DSP in order to decompress the picture and from DSP to 68030 
  84. in order to display the result (transfer of bytes at 16MHz without 
  85. accelerator card).
  86.  
  87.  The informations line of the window displays the following indications:
  88.   - The time passed in seconds.
  89.   - The maximun CPU time occupation in % (over the 20 last pictures), 
  90.     a value in excess of a 100 % normally indicates that the speed in 
  91.     frames per second is not reached.
  92.   - In single step, it's the number of current picture which is 
  93.     displayed instead of maximun CPU time occupation.
  94.   - Number of frames by second.
  95.  
  96.  The graphic mode where you get the fastest display is True Color on 
  97. the FALCON, or in 32768/65536 colors on graphics card for TT or 
  98. HADES.
  99.  
  100.  If the graphic mode is in 256 colors, the movies in 16 millions and  
  101. in 32768 colors are dithered (this slows down the display). If the 
  102. graphic mode is in less than 256 colors, the picture is dithered 
  103. to monochrome (this also slows down the display), or 16 colors in 
  104. this graphic mode.
  105.  
  106.  It's possible to save the movie (all or a part) in this file formats
  107. in relation to the screen resolution:
  108.   - AVI, Video For Windows in Microsoft RLE 256 colors (RLE8).
  109.   - MOV, QuickTime in:
  110.     * Apple Animation RLE 256 colors (RLE8) if screen <= 256 colors.
  111.     * Apple Animation RLE 32768 colors (RLE16) if screen > 256 colors.
  112.  As the default, the selection of pictures starts to number from one up 
  113. to the total number of pictures, or to the current picture if the 
  114. pause is activated. A text shows the corresponding time, if the number 
  115. of the starting or last picture is changed.
  116.  A slider for quality (1 to 5) is only used for RLE16.
  117.  During saving, a red button is displayed at the bottom of the window.
  118.  
  119.  It's possible to save the current picture or a selection of pictures 
  120. in the file formats IMG or TGA, in relation to the screen resolution:
  121.   - IMG, GEM Bit Image:
  122.     * 256 colors if screen <= 256 colors (XIMG).
  123.     * true color 24 bits if screen >= 256 colors.
  124.   - TGA, Targa Image 2.0 in true color 24 bits:
  125.     * conversion starts with 256 colors if screen <= 256 colors.
  126.     * conversion starts with 256 colors if movie in 256 colors.
  127.     * conversion starts with 16 bit high color.
  128.     * 24 bits directly if screen is in 24 bit true color.
  129.     
  130.  As the default, the selection of pictures starts to number from one up 
  131. to the total number of pictures, or to the current picture if the 
  132. pause is activated. A text shows the corresponding time, if the number 
  133. of the first or last picture is changed. The last 5 characters 
  134. are used to number the files for the pictures (for example: 
  135. FRM00001.IMG for the first picture).
  136.  During saving, a red button is displayed at the bottom of the window.
  137.     
  138.  It's also possible to copy the current picture into the clipboard (^C)
  139. (GEM-file SCRAP.IMG).
  140.  
  141.  The formats of compression picture AVI/MOV recognized are:
  142. +-----------------------+----------+-------------+--------------------+
  143. | Name                  | Id       | Colors      | Remarks            |
  144. +-----------------------+----------+-------------+--------------------+
  145. | Microsoft Video 1 MSVC| CRAM8    | 256         | with/without DSP   |
  146. |                       | CRAM16   | 32768       |                    | 
  147. | Radius Cinepak        | CVID     | 256         |                    |
  148. |                       | CVID     | 16 millions | with/without DSP   |
  149. | Intel Indeo R3.1      | IV31     | 16 millions |                    |
  150. | Intel Indeo R3.2      | IV32     | 16 millions |                    |
  151. | JFIF JPEG             | JPEG     | 16 millions | with/without DSP   |
  152. | Apple Uncompressed    | RAW1/2/4 | 2/4/16      | MOV RAW1/2/4       |
  153. |                       | RAW8/16  | 256/32768   | and RAW16/24/32    |
  154. |                       | RAW24/32 | 16 millions |     not tested     |
  155. | Microsoft RGB         | RGB4/8/16| 16/256/32768| AVI RGB4/16/24     |
  156. |                       | RGB24    | 16 millions |     not tested     |
  157. | Apple Animation RLE   | RLE1/2/4 | 2/4/16      | MOV RLE1/2/24/32   |
  158. |                       | RLE8/16  | 256/32768   |     not tested     |
  159. |                       | RLE24/32 | 16 millions |                    |
  160. | Microsoft RLE         | RLE4/8   | 16/256      | AVI RLE4 not tested|
  161. | Apple Video RPZA      | RPZA     | 32768       | with/without DSP   |
  162. | Apple Graphics SMC    | SMC8     | 256         | MOV                |
  163. | Component Video YUV2  | YUV2     | 16 millions | MOV not tested     |
  164. | Intel Raw YUV9 (YVU9) | YUV9     | 16 millions |                    |
  165. +-----------------------+----------+-------------+--------------------+
  166.  The DSP decompressions are possible in true color FALCON and all
  167. lower screen resolutions.
  168.  
  169.  The sound is played with the nearest machine frequency. The exact 
  170. frequency is obtained by enabling 'resample'. Most of the time, the 
  171. resample can quickly be computed by removing or adding a sample,
  172. otherwise the resample is obtained using linear interpollation 
  173. (which is slower).
  174.  
  175.  It's possible to save the sound either with the file frequency if 
  176. resample is not activated, or with the machine frequency if resample 
  177. is activated. This can be in the following file formats:
  178.   - AVR, Audio Visual Research (ATARI).
  179.   - WAV, Microsoft RIFF-WAVE (PC).
  180.   - AIF, Apple Interchange File Format (MAC).
  181.  During saving, a red button is displayed at the bottom of the window.
  182.  
  183.  The formats of compression sound AVI/MOV/WAV recognized are:
  184.   - MS_ADPCM: 16 bits AVI/WAV (APCM), codage on 4 bits.
  185.   - DVI_ADPCM: 16 bits AVI/WAV (DVI), codage on 4 bits.
  186.   - IMA4: 16 bits MOV, codage on 4 bits.
  187.   - ALAW: 16 bits AVI/MOV/WAV (ALAW), codage on 8 bits.
  188.   - MULAW: 16 bits AVI/WAV (ULAW), codage on 8 bits.
  189.   - MAC3: 8 bits MOV, codage on 1/3 bit.
  190.   - MAC6: 8 bits MOV, codage on 1/6 bit.
  191.   - PCM: not compressed AVI/WAV.
  192.   - RAW0: not compressed MOV.
  193.   - RAW: not compressed MOV.
  194.   - TWOS: not compressed signed MOV.
  195.   - IN32: not compressed signed 16 bits stereo MOV.  
  196.  
  197.  A single step mode exists (key '.'):
  198.   - When playing is active, the pause is activated.
  199.   - If pause is active, the next picture is displayed.
  200.  
  201.  The scan (key S) allows you to see all the pictures as fast as 
  202. possible without sound. To start the scan you can also double-clic 
  203. on the FF button in the window.
  204.  
  205.  The slide-show allows you to see all files from the same directory 
  206. as they appear in the directory. If an error occurs, the reading 
  207. continues with the next movie.
  208.  
  209.  During the reading of a file, it's possible to request informations 
  210. about a movie (^I or I):
  211.   - Movie informations:
  212.     * size.
  213.     * number of colors.
  214.     * number of pictures.
  215.     * number of frames per second.
  216.     * step key-frames.
  217.     * duration.
  218.     * number of current picture.
  219.     * type of compression.
  220.     * name of compression.
  221.   - Sound informations:
  222.     * quality (8/16 bits mono/stereo).
  223.     * file frequency.
  224.     * machine frequency (nearest).
  225.     * duration.
  226.     * type of compression.
  227.   - Memory informations:
  228.     * size file buffers in bytes (decompression to screen or picture 
  229.       buffer).
  230.     * size picture buffer in bytes (conversion screen format).
  231.     * size screen buffer in bytes (buffer for redraws, is not used if
  232.       direct screen is checked).
  233.     * size of sound buffers in bytes.
  234.  Or else, statistics can be obtained (^I or I):
  235.   - Real time in seconds.
  236.   - Frames displayed in %.
  237.   - Average CPU time occupation in %.
  238.   - Minimum CPU time occupation in %.
  239.   - Maximum CPU time occupation in %.
  240.   - Average number of frames per second.
  241.  
  242.  
  243. Shortcuts keyboard:
  244. -------------------
  245.  
  246. <CTRL C>         : Copy current image in GEM clipboard
  247. <CTRL E>         : Save movie.
  248. <CTRL I> or <I>  : Informations or statistics
  249. <CTRL L>         : Open AVR/WAV/AIF/RA/MP? file.
  250. <CTRL M>         : Save picture.
  251. <CTRL N>         : Save sound.
  252. <CTRL O>         : Open AVI/MOV/QT/FL?/MPG file.
  253. <CTRL P>         : Open JPG file.
  254. <CTRL Q>         : Quit program.
  255. <CTRL S>         : Save config.
  256. <CTRL U>         : Stop and close movie.
  257. < >              : Switch pause / play movie.
  258. <.>              : Single step.
  259. <-> or ⇩         : Sound level -
  260. <+> or ⇧         : Sound level +
  261. <0> or <F10>     : Use DSP.
  262. <1> or <F1>      : Direct screen.
  263. <2> or <F2>      : Resample.
  264. <3> or <F3>      : Shut-off sound.
  265. <4> or <F4>      : Sound only.
  266. <5> or <F5>      : Control slowness.
  267. <6> or <F6>      : Pass pictures.
  268. <7> or <F7>      : Tape-recorder.
  269. <8> or <F8>      : Little window.
  270. <9> or <F9>      : Without GEM.
  271. <A>              : Loop mode.
  272. <B>              : Quality.
  273. <C>              : Switch color / black and white for CVID/JPEG/YUV/IV.
  274. <D>              : Without D2D.
  275. <O>              : Options menu.
  276. <P>              : Play.
  277. <S>              : Scan.
  278. ⇦ ⇨              : +/-  1 second (impossible for FLI/FLC/FLH).
  279. ⇦ ⇨ and <SHIFT>  : +/- 10 seconds (impossible for FLI/FLC/FLH).
  280. ⇦ ⇨ and <CTRL>   : +/- 60 seconds (impossible for FLI/FLC/FLH).
  281. <HELP>           : Help.
  282. <UNDO>           : Stop and close movie.
  283. <ESC> and 'quit at the end' not checked : Stop and close movie.
  284. <ESC> and 'quit at the end' checked : Quit program.
  285.  
  286.  
  287. Description of options:
  288. -----------------------
  289.  
  290.  The option 'use DSP' active the DSP for some compressions. When used, 
  291. it's shown in the window (FALCON).
  292.  
  293.  The option 'direct screen' causes an extra acceleration of DSP, but 
  294. the displays are less clean (waves on the screen) and the redraws are 
  295. impossible. This option is not always available (256 colors and 
  296. monochrome). In true color FALCON and direct screen, the DSP works
  297. in interrupt mode for transfers, and it's possible to decompress 
  298. picture during loading of the next picture.
  299.  
  300.  The option 'quality' causes an acceleration of the decompression at 
  301. the cost of color-quality (only without DSP). In true color FALCON or 
  302. 32768/65536 colors, the quality is slightly less on compression CVID 
  303. (Cinepak).
  304.  In 256 colors, dithering is disabled for movies in 32768 and 16 
  305. millions colors (this makes it faster without the DSP, but there is 
  306. a substantial quality-loss).
  307.  With compression IV31/32 (Intel Indeo), this option causes an 
  308. acceleration of the decompression at the cost of color-quality. 
  309.  
  310.  The option 'resample' converts sound to respect the frequency file 
  311. (but can slow the machine for some frequencies). On a machine without 
  312. DMA sound, this option is not available because it's possible to 
  313. obtain the exact frequency with the YAMAHA.
  314.  
  315.  The option 'shut-off sound' cuts of the sound for example to answer a 
  316. telephone call.
  317.  
  318.  The option 'sound only' allows you to listen to the sound correctly if 
  319. the display is too slow (sound repeat).
  320.  
  321.  The option 'control slowness' causes an error message if the movie is 
  322. too slow (sound repeat). This message offers to go down one octave, 
  323. switch off the sound or ignore the problem.
  324.  
  325.  The option 'pass pictures' removes the sound repeat because if the 
  326. display is too slow, the animation is stopped till the next entire 
  327. picture. The pictures saved in memory are decompressed and inserted 
  328. during free time (32 at maximum, in this case the size of file buffers 
  329. is multiplied by 32, after this option is disabled).
  330.  
  331.  The option 'tape recorder' allows you to have the classic buttons to 
  332. move through the movie, or a horizontal slider.
  333.  
  334.  The option 'little window' removes the buttons and the move-bar from 
  335. the window to load movies with a larger display.
  336.  
  337.  The option 'without GEM' is the last possibility to increase 
  338. display speed. Only the keyboard is tested directly (goodbye 
  339. multitasking !). In this mode, it's possible to load a movie with a 
  340. picture size of 320 * 240 in a screen resolution of 320 * 240. On a 
  341. FALCON with TV monitor or VGA the display changes to L * H true 
  342. color if the size of the picture does not exceed L * H. The current 
  343. resolution is restored in case of an error or when stopped.
  344.  FALCON  L  *  H
  345.  VGA    160 * 240 25,175 MHz   
  346.  VGA    320 * 240 25,175 MHz   
  347.  VGA    384 * 304 32 MHz (internal or external clock)
  348.  VGA    640 * 480 50 MHz Centurbo II 
  349.  TV     320 * 240 32 MHz
  350.  TV     640 * 480 32 MHz
  351.  
  352.  The option 'without D2D' loads the file into memory (when possible) 
  353. before playing it. The sound is played in 'direct to memory'. Pictures 
  354. are decompressed directly.
  355.  
  356.  The option 'loop mode' causes the file to start again at the end or
  357. to first file with slide-show. 
  358.  
  359.  The option 'quit at the end' is useful if the program is called by 
  360. another program with a command line. This option has no effect if the 
  361. option loop mode is activated.
  362.  
  363.  The option 'pause at start' causes a pause on the first picture and
  364. equally on the end of file. 
  365.  
  366.  The option 'without error' causes the suppression of the skip alerts 
  367. box and the error 'End of file abnormal'.
  368.  
  369.  It's possible to save all options (^S).
  370.  
  371.  
  372. Display configuration:
  373. ----------------------
  374.  
  375.  The 'delay slide show picture' allows to fix the display during 0 to 
  376. 99 seconds.
  377.  
  378.  The selection 'without GEM display' allows to choose the display mode
  379. when the option 'without GEM' is activated:
  380.  
  381.   - Automatic: Display changes on FALCON, and zoom 2X if the CPU is 
  382.     >= 68040 and the size of picture is <= 384 * 304 on VGA and
  383.     640 * 480 on TV.   
  384.   - Normal: Force normal size.
  385.   - Zoom 2X: Force zoom 2X.
  386.  
  387.  The selection 'dithering in 256 colors' fix the palette used in 256
  388. colors for dithering:
  389.  
  390.   - Player palette: Fixed palette of 216 colors.  
  391.   - Current palette: Approximates colors with current palette.
  392.   
  393.  Configuration of 'File selector' possible:
  394.  
  395.   - Automatic: Uses Magic file selector (if Magic is installed).
  396.   - TOS: Uses always TOS file selector.
  397.   - No popup: Same as TOS, but removes popup-menu in main menu 
  398.     (selection *.*).  
  399.  
  400.  The selection 'speed video without sound' allows to choose the
  401. number of frames by seconds for files without sound:
  402.  
  403.   - Normal: Speed of original file.
  404.   - Forced: Force the number of frames by seconds at 1 to 99 (FLI
  405.     files for example).
  406.  
  407.  
  408. Sound configuration:
  409. --------------------
  410.  
  411.  The selection 'direct to disk' allows to choose the playing mode:
  412.  
  413.   - Automatic: The direct to disk is always used if the file allows it.
  414.     For example the preload of sound is used for Real Audio 28.8K files
  415.     if the CPU is < 68060.
  416.   - Preload: The preload of sound is used for AVI/MOV/RA/MP files. The
  417.     option 'without D2D' (allowing to do D2RAM in loading all file in 
  418.     memory) is disabled in case preload sound is checked.
  419.   - Force: Force the direct to disk for Real Audio 28.8K files.
  420.   
  421.  The selection 'sound system' changes configuration of playing sound:
  422.  
  423.   - Automatic: Uses directly the hardware if it's possible.
  424.   - XBIOS: Force use of XBIOS if functions exists.
  425.   - Analog: Uses two analogics channels.
  426.   - Digital: Uses eight digital channels, normally for DSP port of FALCON
  427.    (Analog 8 of Soundpool for example). 
  428.  
  429.  The selection 'CD clock' allows on FALCON to choose the test of 
  430. external clock (DSP connector) for CD frequencys:
  431.  
  432.   - Automatic: Test when Aniplayer is started.
  433.   - Ignore: External clock ignored.
  434.   - Force: Shows than external clock is connected without made a test.
  435.   
  436.  The selection 'Mode DSP MP3' allows on FALCON to choose the mode
  437. of work for DSP and MP3:
  438.  
  439.   - Normal: DSP transfers are normals (by host port).
  440.   - DMA transfers DMA: DSP transfers DSP by the DMA and direct audio 
  441.     output (more fast).
  442.     
  443.  The selection 'Mode sans DSP MP3' allowsto choose the mode of
  444. decompression of MP3 with only the CPU:
  445.  
  446.   - Normal: Two channels are used for decompress MP3 stereo.
  447.   - Force in mono: More fast with an MP3 stereo.
  448.  
  449.  
  450. Command ligne:
  451. --------------
  452.  
  453.  If the command line contains at least one of the following options, 
  454. the program is started as a TTP program:
  455.   +annnnnnnnnn    : adress for control program (10 numbers max)
  456.   +bnnnnn         : force number of planes for screen (5 numbers max) 
  457.   +d              : with DSP (-d: without DSP)
  458.   +e              : display errors (-e: without, default +e)
  459.   +hnnnnn         : force height of screen (5 numbers max)
  460.   +i              : loop (-i: without)
  461.   +m              : with pictures (-m: sound only)
  462.   +o name_target  : convert file (save in AVR/WAV/AIF/AVI/MOV)
  463.   +p              : with sound (-p: shut-off sound)
  464.   +q              : with quality (-q: without)
  465.   +r              : resample sound (-r: without)
  466.   +s              : pass pictures (-s: all pictures)
  467.   +wnnnnn         : force width of screen (5 numbers max)
  468.   +xnnnnn, +ynnnnn: movie position (5 numbers max, default center)
  469.   +znnnnnnnnnn    : adress informations about movie (10 numbers max)
  470.  
  471.  The directory and name of file follow the options, e.G.:
  472.   +d +r C:\MOVIES\X.MOV read X.MOV with dsp and resample.
  473.   -p C:\MOVIERS\*.MOV read all MOV of directory without sound. 
  474.   +p C:\MOVIERS\*.* read all files of directory with sound. 
  475.    
  476.  The options not showed proceed of ANIPLAY.INF file. If this file not 
  477. exist, the default options are +d +i +m +p +q +r +s.
  478.  The options direct screen, without GEM, and quit at the end are 
  479. checked.
  480.  The option control slowness and without D2D are not checked.
  481.  
  482.  This mode not work in screen resolutions 4 colors (GEM is not used).  
  483. On FALCON, if the picture is lower or equal to 320 * 240, the screen 
  484. resolution change in true color.
  485.  If the movie position is checked (+x +y), the screen resolution 
  486. doesn't change in true color on FALCON. In this mode, the background
  487. is not cleared. In the screen resolution with planes, x is aligned to
  488. 16 pixels. 
  489.  
  490.  Adress (+a) is used for the control program. An example for 
  491. programmers is better than an explanation:
  492.  
  493.  In C (simplified):
  494.  {
  495.    Pexec(0,"ANIPLAY.PRG","+x100 +y100 +aadress C:\MOVIES\X.MOV",""); 
  496.  }
  497.  
  498.  int adress()
  499.  {
  500.    switch(code())
  501.    {
  502.    case END:
  503.      return(0x1b);   /* ESC */
  504.    case PAUSE:
  505.      return(' ');
  506.    case REW:
  507.      return(0x4B34); /* SHIFT + ⇦  (-10S) */
  508.    case FF: 
  509.      return(0x4D36); /* SHIFT + ⇨  (+10S) */
  510.    }
  511.    return(0);
  512.  }
  513.  
  514.  Adress informations (+z) doesn't play movie but returns informations 
  515. about movie. This possibility is usefull for programmers (32 bytes 
  516. buffer):
  517.  
  518.  struct infos
  519.  {
  520.    int width;
  521.    int height;
  522.    int planes;
  523.    int frames_second;
  524.    long total_frames;
  525.    long id_picture_compression; /* cvid for example */
  526.    int quality; /* B0: mono(0)/stereo(1)  B1: 8 bits(0)/16 bits(1) */
  527.    unsigned int frequency_file;
  528.    unsigned int frequency_machine;
  529.    long total_samples;
  530.    long id_sound_compression;  /* ima4 for example */
  531.    int version_player;         /* version of Aniplayer */
  532.  }
  533.  
  534.  
  535. GEM messages:
  536. -------------
  537.  
  538. Message VA_START:
  539.  
  540.  msg[3] = Path (high)
  541.  msg[4] = Path (low)
  542.  
  543.  A command line can be joined:
  544.  
  545.   +c: with control slowness (-c: without)
  546.   +d: with DSP (-d: without DSP) 
  547.   +g: with GEM (-g: without GEM)
  548.   +i: loop (-i: without)
  549.   +k: with keyboard (-k: without for use only AV_SENDKEY)
  550.   +l: little window (-l: normal window)
  551.   +m: with pictures (-m: sound only)
  552.   +o name_target: convert file (save in AVR/WAV/AIF/AVI/MOV)
  553.   +p: with sound (-p: shut-off sound)
  554.   +q: with quality (-q: without)         
  555.   +r: resample sound (-r: without)
  556.   +s: pass pictures (-s: all pictures)
  557.   +t: tape recorder (-t: slider)
  558.   +v: with direct screen (-v: without)   
  559.   +xnnnnn, +ynnnnn: movie position (5 numbers max, default center)
  560.  
  561.  
  562. Message 'MP' (M_PLAYER):
  563.  
  564.  msg[3] = Path (high)
  565.  msg[4] = Path (low)
  566.  
  567.  A command line can be joined:
  568.  
  569.   +d: with GEM (-d: without GEM)
  570.   +i: loop (-i: without)
  571.   +o name_target: convert file (save in AVR/WAV/AIF/AVI/MOV)  
  572.   +p: with sound (-p: shut-off sound)
  573.   +s: pass pictures (-s: all pictures)
  574.   +xnnnnn, +ynnnnn: movie position (5 numbers max, default center)
  575.  
  576.  msg[5] = 0 or message ('MP' for example)
  577.             for a return's message at the end of file              
  578.  
  579.                                      
  580. Message AV_SENDKEY:
  581.  
  582.  msg[4] = Pressed key (GEM format)
  583.  
  584.  
  585. Message 'AP':
  586.  
  587.  - Message for a new position in seconds:
  588.  
  589.    msg[3] = 1
  590.    msg[4] = Seconds (high)
  591.    msg[5] = Seconds (low)
  592.  
  593.    No answer message.
  594.  
  595.  - Message for a new position in pictures:
  596.  
  597.    msg[3] = 2
  598.    msg[4] = Picture (high)
  599.    msg[5] = Picture (low)
  600.    
  601.    No answer message.
  602.  
  603.  - Message for get informations:
  604.  
  605.    msg[3] = 0
  606.    
  607.    Answer message 'AP':
  608.  
  609.    msg[3] = Structure (high)
  610.    msg[4] = Structure (low)
  611.  
  612.    typedef struct
  613.    {
  614.      int width;
  615.      int height;
  616.      int planes;
  617.      int frames_second;
  618.      long total_frames;
  619.      long id_picture_compression; /* cvid for example */
  620.      int quality; /* B0: mono(0)/stereo(1)  B1: 8 bits(0)/16 bits(1) */
  621.      unsigned int frequency_file;
  622.      unsigned int frequency_machine;
  623.      long total_samples;
  624.      long id_sound_compression;  /* ima4 for example */
  625.      int version_player;         /* version of Aniplayer */
  626.      long count_seconds;
  627.      long num_frame;
  628.      int reserve[12];
  629.    } INFO_ANIM;
  630.  
  631.  
  632. Questions/answers:
  633. ------------------
  634.  
  635.  What options to choose on a FALCON, for the display to be faster ?
  636.  - Choose screen resolution 320 * 240 (or 480) in true color on a VGA 
  637.    monitor (clock 25 MHz), or best 320 * 200 on TV/RGB.
  638.  - Check use DSP.
  639.  - Check direct screen.
  640.  - Check without GEM. 
  641.  - Load the file. 
  642.  
  643.  The program sometimes displays: 'Impossible to load the block to 
  644. decompress in DSP memory', is this normal ?
  645.  - The file is not compressed enough. The pictures to decompress are 
  646.    segmented by blocks, and the DSP decompresses a minimum of one 
  647.    block. To resolve the problem, it must treat a fraction of the 
  648.    block, and this operation can slacken pictures well compressed.
  649.  - The program unchecks the DSP and restarts playing.
  650.  
  651.  How to use the slide show when I don't know the size of the movies on 
  652. the FALCON ?
  653.  - Choose a screen resolution higher or equal to 640 * 480 in 256  
  654.    colors.
  655.  - Check use DSP.
  656.  - Check direct screen.
  657.  - Check without GEM.
  658.  - Choose the directory for the slide show.
  659.  - If the picture is smaller or equal to 320 * 240, the display changes 
  660.    to 320 *240 in true color (this is the case with most of the movies).
  661.  - If the display is higher than 320 * 240 the display is performed in 
  662.    the current screen resolution (this is the case with most of the 
  663.    photography, with a speed near too one frames/s, it's not penalized).
  664.  
  665.  
  666. Material used for tests:
  667. ------------------------
  668.  
  669. FALCON 030 with Speed Resolution Card (68030 to 40 MHz, bus to 20 MHz, 
  670. DSP to 40 MHz) in SVGA 640 * 400 true color (clock 40 MHz).
  671. CD-ROM SCSI PIONNER 10X with SPIN for driver.
  672.  
  673.  The limits of the program are obtained approximately with a movie
  674. 320 * 240 with CVID 12 frames/s if the pictures are not enough 
  675. compressed (sound repeats because of too much data to be transfered
  676. to the DSP).
  677.  
  678.  
  679. Shareware:
  680. ----------
  681.  
  682. Aniplayer is Shareware NOT public domain.
  683.  
  684. For registration, please send:
  685.  
  686. - US$10, CAN$15, 15DM, 7UKP or 50FF to my adress:
  687.  
  688.         Didier MEQUIGNON
  689.         25, rue de l'Ascenseur 62510 ARQUES
  690.         FRANCE
  691.  
  692. - This informations:
  693.  
  694. Name
  695. Adress
  696. Town Country
  697. E-mail
  698. Your computer for information
  699.  
  700. After receiving the Shareware fee you will receive a personalised key. 
  701. This key with your name and adress is entered into the Aniplayer 
  702. registration dialog and is saved in ANIPLAY.INF file. After saving the 
  703. .INF file with a key the registration dialog no longer appears.
  704. A modification of this file can destroy the key.
  705.  
  706. Registrations can also be sent to:
  707.  
  708. CyberSTrider
  709. PO Box 2023
  710. Wickford
  711. SS12 9RX
  712. UK
  713.  
  714. Cheques in UKP payable to CyberSTrider
  715. Cheques payable in USD payable to Denesh Bhabuta
  716.  
  717. UKP price: 10 UKP
  718. USD price: 16.50 USD
  719.  
  720. You will receive a keycode via email/letter. Masterdisks, add 2UKP.
  721. Please refer to CyberSTrider order form for further details, or email.
  722.  
  723. Electronic contact details:
  724. denesh@cyberstrider.net
  725. www.cyberstrider.org
  726.  
  727.  
  728. Thanks (contribution or ideas):
  729. -------------------------------
  730.  
  731.  Bertrand Marne to Rosny Sous Bois (F).
  732.  Simon Yardley to Ashingdon Rochford (GB).
  733.  Christophe Ricard to Grabels (F).
  734.  Yu-Ou Wang to Paris (F).
  735.  Pascal Ricard to Pierrevert (F).
  736.  Bruno Levionnois (F).
  737.  Houplon Joël to Chaville (F).
  738.  Philippe Conceicao to Schiltigheim (F).
  739.  Christophe Villeneuve to Bourges (F).
  740.  Guillaume Tello to Montreuil Bellay (F).
  741.  Bruno Bégni to Saint-Gingolph (F).
  742.  Denis Huguet to Mehun sur Yèvre (F).
  743.  Jean-Jacques Ardoino (F).
  744.  Mille Babic to Göteborg (S).
  745.  Rémi Vanel (F).
  746.  Thierry Benet (F).
  747.  Joachim Fornallaz to Zürich (CH).
  748.  Magnus Kollberg (S).
  749.  Karel Post (NL).
  750.  Francois Le Coat (F).
  751.  Nicolas Boulesteix to Gaillon sur Montcient (F).
  752.  Raymond Collins (US).
  753.  Philippe Castella (F).
  754.  Loïc Sébald to Caveirac (F). 
  755.  Christian Marillat (F).
  756.  Clément Benrabah (F).
  757.  Noah Silva (US).
  758.  Frédéric Boudet to Tonneville (F).
  759.  Patrick Delecluse to Bruille St Amand (F).
  760.  Jo Vandeweghe to Dottignies (B).
  761.  Oliver Heun to Mainz (D).
  762.  Alexander Kartalija to Bad Durrheinidem (D).
  763.  The Removers (F).
  764.  Thomas Raukamp (D).
  765.  Alexander Clauss (D).
  766.  Robert Blätter to Hamburg (D).
  767.  Karel de Bruijn to St. Jansteen (NL).
  768.  Gilbert Duquesne to Lille (F).
  769.  Alain Larrodé to Villacoublay (F). 
  770.  Nicolas Richeton to Poitiers (F).
  771.  Bernd Maedicke (D).
  772.  Jan Daldrup to Kaarst (D). 
  773.  Sasa Andrijasevic (HR).
  774.  
  775.  
  776. Others realisations:
  777. --------------------
  778.  
  779.  PICDESK, display a picture (X)IMG/GEM or a motif on the GEM desktop, 
  780. new file select, news screen resolutions, fast display, and dead keys.  
  781. Freeware. FALCON.
  782.  
  783.  SONDIGIT, sound digitizer with or without direct to disk, formats 
  784. WAV/AIF/AVR/DVS. Freeware.
  785.  
  786.  
  787.                  MEQUIGNON Didier, February 2000
  788.                  
  789.                  
  790. P.S.
  791. ----
  792.  
  793.  The cases 'not tested' are either due to the absence of a graphic 
  794. card, or absent files in these formats (compression) in order to 
  795. test my program... If you have a problem with your graphic card, 
  796. please contact me.
  797.  
  798.  For all information on the compressions not recognized, suggestions,
  799. or remarks about my program, you can write to this adress:
  800.  
  801.             25, rue de l'Ascenseur 62510 ARQUES FRANCE
  802.             
  803.  Or a message on:
  804.  
  805.               internet e-mail: didier.mequignon@wanadoo.fr
  806.                        web: http://perso.wanadoo.fr/didierm/
  807.                             http://aniplay.atari.org
  808.  
  809.  If you contact me for a problem (bug), please mention the 
  810. following:
  811.   - The version of ANIPLAYER.
  812.   - The machine (and the accelerator card if present).
  813.   - The graphic mode or card used.
  814.   - The options checked.
  815.   - The file format.
  816.   - The type of compression (visible by ^I or I).
  817.   - The details of the problem.
  818.  
  819.  I keep listening to all suggestions if you want the evolution of my 
  820. player to continue...
  821.  
  822.